home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TB / (A)TBH.ADF / Geotime / readme.first < prev    next >
Text File  |  1989-09-12  |  10KB  |  242 lines
  1.                   Geotime - The "Ultimate" (?) Amiga clock
  2.  
  3.                        Copyright 1988 by Mike Smithwick
  4.  
  5. Like many people, I was getting pretty board with the plethora of
  6. rather dull little workbench clocks (mouse pointer clocks, Boing
  7. clocks, etc), I decided to write Geotime. 
  8.  
  9. Geotime actually consists of two separate programs, Geotime_m depicts
  10. a earth map with day and nite sides shaded. You'll be able to observe
  11. the earth's shadow scroll across the map in real-time based on the
  12. system clock.
  13.  
  14. The other program, Geotime_g is a workbench clock, and shows the
  15. earth as a globe with day and nite sides. Like the map, the shadows
  16. will progress in real-time showing the current phase of the earth.
  17.  
  18. And now a word from our sponsor:
  19.  
  20. Geotime is freely distributable, as long as this notice stays intact.
  21. However, this is, "Shareware" (oh no Mr. Bill, not shareware!). Wait!
  22. Don't go!! I know that the shareware concept is much overused,
  23. particularly since most shareware products aren't worth it. If you do
  24. enjoy this program, I would enjoy, say, $17. This will ensure a free
  25. upgrade which will not be freely distributable. Please feel free to
  26. suggest further features for the next version. I expect to have
  27. higher detailed maps, zoom in/out, time-zone boarders, etc.
  28.  
  29. Mail you generous cash contributions to :
  30.  
  31.                 Mike Smithwick
  32.                 25215 La Loma Drive
  33.                 Los Altos Hills, CA   94022
  34.  
  35. This of course assumes that there is enough interest to warrent
  36. further time spent on this.
  37.  
  38. "And we thank you for your support".
  39.  
  40.  
  41. ---------------------------------------------------------------------
  42.  
  43.                                  Geotime_m
  44.  
  45. Geotime_m will display a map of the earth showing the current day and
  46. nite regions. The shadow will scroll across the map in real time.
  47. This program was inspired by "Geochron", the beautiful, illuminated
  48. large wall map that costs around $4 million bucks (actually, about 2
  49. grand).
  50.  
  51. It is started in the traditional double-click icon method. For those
  52. who despise workbench, it may be started up from CLI by typing 
  53. "geotime_m -f coast2.sm.bin".
  54.  
  55. City and country names are read from the file "gtnames.dat". Each
  56. entry requires 3 lines in the following format :
  57.  
  58.                       name
  59.                       lat long
  60.                       time_zone
  61.  
  62. West longtitude is negative, East is positive. The time-zone is the
  63. value the must be added to your time to equal Universal Time. Most
  64. almanacs should have timezone entries for major cities.
  65.  
  66. Here's a sample entry :
  67.  
  68.                        .San Francisco
  69.                        38 -122
  70.                        7
  71.                        .Seoul
  72.                        37 127
  73.                        -9
  74.                        .London
  75.                        51 0
  76.                        -100
  77.  
  78. Time zones are floating point values since some zones are fractional
  79. hours. (The timezones in the sample file may not be correct due to
  80. the uncertainties of Daylight times around the world).
  81.  
  82. Each name will automatically be followed by a clock showing the time
  83. in 24 hour mode. Using a time-zone value of "-100" (as in the London
  84. entry) will prevent the clock from being displayed to avoid excess
  85. screen clutter.
  86.  
  87. The period before the name is used to more clearly pinpoint the
  88. location.
  89.  
  90. The star-like sprite shows the "sub-solar" point, the point on the
  91. Earth directly under the sun.
  92.  
  93. There are a couple of options you may change by use of the Workbench
  94. Icon "Tooltypes" facilities. These are used to pass startup
  95. information on to a program. Click once on the icon, then select
  96. "info" from the workbench menu. You will now see the "Info" window
  97. displaying all sorts of curious attributes about it's associated
  98. file. Near the bottom is the "TOOL TYPES" string gadget. Click on the
  99. arrows, and you see 3 different startup options. "GLOBEDATA" tells
  100. the program where to get it's map data file. For Geotime_m there is
  101. currently only one file, "coast2.sm.bin", so you don't need to touch
  102. this unless you move the datafile over into another directory. Next
  103. is the "TIMEZONE" argument. This is the timezone for your location,
  104. and is determined the same way as all other timezones. The program
  105. uses this to convert the local time on your system's internal clock
  106. to Universal time. It is currently set up for Pacific time. You may
  107. also change the landmass colors using "LANDCOLOR". The following 3
  108. numbers are the red, green and blue components. So if you wanted
  109. magenta land you would type "LANDCOLOR=15,0,15", or all red, no
  110. green, all blue. (The color values go frome 0 to 15). When done
  111. modifying the tooltypes, click on save. You may want to open the info
  112. window one more time to verify that your numbers were correctly
  113. recorded, as I ran in to some problems in this regard.
  114.  
  115. Geotime_m requires the use of a special font, "flow_thin". In order
  116. to install the font, open a cli window and type "execute
  117. gt:font_install".
  118.  
  119. There are a couple of menu options that allow you to toggle on/off
  120. the clocks, names, and a clock in the menubar.
  121.  
  122. ---------------------------------------------------------------
  123.  
  124.                                  geotime_g
  125.  
  126. Geotime_g will depict the earth as if you will an astronaut orbiting
  127. about 300 zillion miles up. The earth's shadow will be correct for
  128. the date and time, and will advance as time itself advances.
  129.  
  130. Start this up via the icon, or CLI as mentioned above using 
  131. "geotime_g -f coast2.bin". (Notice that different data files are used
  132. for each program).
  133.  
  134. At startup you are in "orbit" mode, in which the viewpoint in effect 
  135. "orbits" around the planet. (otherwise it would be a really boring
  136. display.)
  137.  
  138. Geotime will work in both interlace and non-interlaced modes.
  139. Although it looks the niftiest in Hi-res interlace with dropshadow.
  140.  
  141. Since Geotime uses your own workbench colors you may have reset your
  142. preference colors for what looks best on both Geotime and your
  143. workbench. Colors are very important. The water should be dark-blue,
  144. land masses brown/orange or green, sky-black. In order to see the
  145. colors I used, I've included my own "system-configuration" file on
  146. the disk which hold my preference data. You may want to substitute
  147. this for your own in the df0:devs directory.
  148.  
  149. There is just one Tooltype entry for this one, and that is
  150. "GLOBEDATA". As with the Geotime_m, there is currently only 1 file,
  151. "coast2.bin".
  152.  
  153. If the globe is not circular, your monitor may need some adjustment.
  154. It may take an update or two for any changes in the settings window
  155. to take affect.
  156.  
  157. Geotime_g has several menu options. . .
  158.  
  159.                              System menu
  160.  
  161. In the systems menu, "settings" will allow you to set some basic
  162. information needed. Timezone is the number of hours which you need to
  163. add to your local time to arrive at Universal Coordinated Time (the
  164. old "GMT"). +7 is good for the SF Bay Area.
  165.  
  166. View lat : sets the viewer latitude. Defaults to 0 degrees. (dd.mm
  167. format) Setting this positive will put you above the equator when
  168. looking at the globe.
  169.  
  170. View long : sets the viewer longtitude. Defaults to 0 degrees. This
  171. advances 5 degrees each update while in orbit mode.
  172.  
  173. Lat : user's latitude. Put your home's latitude here for the
  174. "location" highlight option. 
  175.  
  176. Long : user's latitude. Put your home's longtitude here.
  177.  
  178. Save : This will save all of your settings to a file, "geotime.dat".
  179.  
  180. If you make a mistake, the screen will flash a bunch of times and you
  181. won't be able to leave the requestor.
  182.  
  183. The latitudes go from -90 to +90 degrees. Longtitudes go from 180 W
  184. to 0 to 180 E. So for instance, the longtitude for San Francisco,
  185. 122:27 degrees West, would be entered as "122.27 W".
  186.  
  187.                           Neat Stuff menu
  188.  
  189. Highlights : "Continents" will put an outline on the land masses. 
  190.              "Location" will put a "*" at whatever location you
  191. specify in the settings window.
  192.  
  193. Indicators : "Clock" will display the current date and time, while
  194. "legend" shows how the sunny side is colored vs. the shaded side.
  195.  
  196. Mode : This lets you toggle between the orbit/hover rotational modes.
  197.             "Orbit", the default, presents the planet to you as if
  198. you were orbiting around in a very fast spacecraft from West to East.
  199.             "Hover" puts you above a fixed point specified by the
  200. view lat/view long entries in the settings window. Hover is a really
  201. dull mode.
  202.  
  203. Shadow : "Shaded", the default, gives you a shadow tint, while
  204. "black" will completely blacken the shadow to more closely mimic the
  205. view from space.
  206.  
  207. ---------------------------------------------------------------------
  208.  
  209.                                      Misc
  210.  
  211. The data used contains about 3000 points culled from a 6000 point
  212. database. (I may release the larger one sometime, it doesn't look
  213. that much better on the globe, but it is quite nice on the map).
  214.  
  215.  
  216. ---------------------------------------------------------------------
  217. (Warning! Warning! The following is an unabashed commercial
  218.  announcement!)
  219.  
  220. If you do enjoy this program, you may want to take a look at
  221. something else I've done. It's called "Galileo", and is an astronomy
  222. simulation. It will display up to 9100 stars in a fashion more
  223. realistic than any other micro-computer planetarium simulation.
  224.  
  225. Galileo has won an award in the May Consumer Electronics Show for the
  226. most innovative Educational Program of the Year.
  227.  
  228. A recent review in Sky and Telescope magazine called Galileo
  229. "powerful and visually stunning", and many users write in to me
  230. saying things like "at last, a program that justifies my Amiga", or
  231. "Wonderful!".
  232.  
  233. Galileo is not meant just for folks with a telescope, but for anyone
  234. who has ever wondered about what's up in the night sky. (As a matter
  235. of fact, only a handful of owners stated they had a telescope. But
  236. those who do love the program).
  237.  
  238. So, when you're tired of exploring fictional universes, give the real
  239. one a shot, I think you'll enjoy it.
  240.  
  241.              (End of the unabashed commercial announcement!)
  242.